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Listing |. Typical ioctl calling sequence 
With the use of Linux becoming increasingly common, includ- // build the transfer structure 
ing among the readers of Elektor Electronics, there is grow- emd.vall = CY3640_READ_ROM; 

ing interest in Linux drivers for E/ektor Electronics interface cmd: val? E adar; 

projects. One of the most successful projects in recent years A T 4 

was the USB interface presented in the September 2000 issue, 

for which a driver for Windows 98 was developed, but not for 
Linux. It’s time to set that right! 

Linux supports USB in kernel versions 2.4.0 and above. For 
kernel versions 2.2.16 and above, there is also limited USB 
support. In principle, there are two options for accessing a 
USB device: 


e access via a user-supplied module incorporated into the 


// call the ioctl 
ioct1(£d,CY3640 READ ROM, &cmd); 


// output the results 
printf(“rom at addr 0x%02x is 
0x%20x\n"”,addr,cmd.val2); 


kernel that communicates with the interface; 
e access via the USB file system (usbdebfs), which can also 
execute the Control Request provided by the USB interface. 
Here we take the approa ch of using our own kernel mod- 
ule, which is a piece of code that can be dynamically loaded 
into the operating system kernel as well as dynamically 
deleted, and which implements a particular function — such as 
accessing the F/ektor Electronics USB interface. This not only 
makes it very easy to test the code, it also means that the 


coded in the module and employs USB Major Number 180 
and Minor Number 128. 

In order to activate the module, it must be loaded into the kernel 
using the command insmod cy3640.0. The command 1smod 
can be used to verify whether this was successful. In addition, 
the file descriptor must be created once using the command 


mknod /dev/usb-elektor 
c 180 128 


operating system kernel is 
not burdened with unnec- 
essary code. 

The cy3640.0 kernel 
module is a modified ver- 
sion of a driver that we 
found on the Internet for the 
Cypress Starter Kit, which 
uses the same hardware as 
the Elektor Electronics USB 
interface. 

This module provides 
access to all of the func- 
tions implemented in the 
interface using 
routines, which are spe- 
cial calls for devices that do 
not fit into the normal 
read/write scheme. Each 
ioctl employs a 4-byte 
structure that is used to 
transfer values and return 
results. A typical call 
sequence is shown in List- 
ing 1. The calls that have 
been implemented are 
listed in Table 1. 

The file descriptor is hard- 


ioctl 


96 


Table |. ioctl functions 
Ioctl In 
CY3640 PING =p=ya9e 


CY3640 SET BRIGHTNESS -,brightness,-,- 


CY3640_ READ TEMP Ser 
CY3640_ READ PORT 
CY3640_ WRITE PORT 
CY3640_READ_RAM 
CY3640_ WRITE RAM 
CY3640_READ_ROM 


-,port,-,- 
-,address,-,- 


-,address,-,- 


Table 2. Access library functions 
Function 


void set_device (char *device) 


void brightness (int val) 

unsigned char read port (int port) 
void write port (int port, int val) 
unsigned char read _ ram (int addr) 
void write _ram (int addr, int val) 
unsigned char read_rom (int addr) 
float read_temp (void) 

int read_button (void) 


int ping device (void) 


-,port,value,- 


-,address,value,- 


Out 

status,-,-,- 

status,-,-,- 
status,temp_low,temp_high,button 
status,value,-,- 

status,-,-,- 

status,value,-,- 

status,-,-,- 


status,value,-,- 


Remarks 


Sets the name of the device file. 

Must always be the first function called. 
Sets the brightness of the green LED. 
Reads the specified port. 

Writes the specified port. 

Reads the specified RAM address. 
Writes the specified RAM address. 
Reads the specified ROM address. 
Reads the temperature. 

Reads the state of the pushbutton. 
Tests whether the interface is operational. 
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and its access privileges must be set to read/write for everyone 
using the command 
chmod 0666 /dev/usb-elektor 


Root privileges are required for these operations. 

The module must be reinstalled each time the system is 
started up. Automatic installation using usbmgr or hotplug 
scripts is not possible. 

In order to avoid having to use the rather tedious ioctl pro- 
gramming every time, an access library containing the func- 
tions listed in Table 2 has been created. This hides the ioct1 
calls from the user. 

The Linux counterpart to Visual Basic in Windows is called 
Tel/Tk. Tk is an interpreter that provides a graphic user interface 
and into which dynamic libraries can be loaded. These fea- 
tures make it an ideal testing tool for rapidly generating user 
interfaces. 

The download file for this project, number 010065-11, con- 
tains the previously described access libraries and the kernel 
modules for kernel versions 2.2.x and 2.4.x. It also contains a 
shared library for use with Tcl/Tk and several demo programs, 
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Recommended literature: 


The Universal Serial Bus (USB). 
Elektor Electronics September 2000 
(description of the USB interface). 


www.linux-usb.org 
Introductory site for USB under Linux, including access to 


the USB mailing lists 
The Linux USB subsystem, Brad Hards, Sigma Bravo Pty Ltd. 


Programming Guide for Linux USB Device Drivers. Detlef Fliegel. 
http://usb.cs.tum.edu 





A USB Driver for the Cypress USB Starter Kit. Craig Peacock. 
www. beyondlogic.org/usb/cypress.htm 





Practical Programming in Tcl and Tk. Brent B. Welch. 
Prentice Hall, 1999. 


as well as the illustrated Tcl/Tk application in both German and 
English versions. 
(010065-1) 


